home *** CD-ROM | disk | FTP | other *** search
/ Amiga Packmags / NewsFlash - Issue 07 (1990-01)(UGA - 17-Bit Software)(Disk 1 of 2)[a].zip / NewsFlash - Issue 07 (1990-01)(UGA - 17-Bit Software)(Disk 1 of 2)[a].adf / prog / bootleg.doc < prev    next >
Text File  |  1988-01-19  |  6KB  |  158 lines
  1.  
  2. Programname:    BOOTLEG V2.1
  3.  
  4. Author       :    BOIL / JUNGLE COMMAND
  5.  
  6. History       :    BOOTLEG V1.0 BY MCS
  7.         BOOTLEG V2.0 BY BOIL (released on 1st of April, hehe)
  8.  
  9. Improved   :    Segment Supported (working)
  10.            (fake)BSS supported
  11.            BitMap supported
  12.  
  13. Warning !!!:    Always use an backup of your original disk.
  14.         Especially when you are experimenting.
  15.  
  16.         Exclusive first release for UGA software
  17.  
  18.     Bootleg V2.1 is freeware provided that this readme file
  19.     is present on any disk containing Bootleg V2.1
  20.  
  21. ---------------------------------------------------------------------------
  22.  
  23. Introduction
  24. ------------
  25.  
  26. This program allows you to make a custom bootblock that can load a
  27. program direct in memory and run it.
  28. It can write on any AMIGA-DOS formatted and installed disk without
  29. destroying filedata on that disk.
  30. While writing on the disk the blocks will be allocated and from track 0
  31. only free sectors will be used !
  32. So you don't have to look for empty sectors or rearranging the disk.
  33. If you have 30 sectors free then you can write 30*$200=$3c00 bytes
  34. without arranging the disk.
  35. But the best result will be on an empty disk before you put anything
  36. on it because the trackloader can read it all at once.
  37.  
  38. BSS
  39. ---
  40.  
  41. BSS is a section (segment) of datas defined as 0 at start.
  42. The advantage of BSS is that is takes almost no disk space.
  43. For example Bootleg V2.1 is about 11 kilobytes big if you load it
  44. but on disk the lenght is only about 7 kilobytes.
  45. Bootleg also has an seperate BSS table to make sure these datas
  46. are 0 and ofcourse this will not take any diskspace.
  47.  
  48. Install bootblock only
  49. ----------------------
  50.  
  51. I made this option to allow you to load multiple absolute parts
  52. into memory and then run it. (e.g. a separate part for graphics,
  53. music and code)
  54. You have to save the datas on disk yourself because I won't do it for
  55. you, it's best to use an empty disk for this option.
  56. This option writes only a bootblock !
  57. Might come in handy when experimenting.
  58.  
  59. Load an reloc file
  60. ------------------
  61.  
  62. The essence of this program ! It supports segments unlike our first
  63. bootleg and as mentioned before a BSS segment will be put in a seperate
  64. table to clean memory before running.
  65. If you have some fastmemory please remember that Bootleg makes the
  66. segments absolute so that the program won't run on a expanded machine.
  67. As the trackdisk device cannot write or read from/into fastmemory
  68. you have to use NoFastMem or copy in our own program to fastmem.
  69. (DMA only can access into chip memory)
  70. To force a program to load in Chip memory you can alter the hunk
  71. structure with a handy program like : atom, scatom, hunkwizard
  72. (I think this prg is better than dugger, ringside and the whole
  73. lot together!)
  74. There must be enough empty sectors to save the program on.
  75.  
  76. Load an Absolute file
  77. ---------------------
  78.  
  79. Almost the same as the reloc file loader only it works already absolute.
  80. When IO_Data is requested then you have to enter the loadaddress 
  81. where you want the program to start in memory.
  82. If you press return then the loadaddress is the startaddress otherwise
  83. enter the jsr address yourself.
  84. Remember that if you load an relocfile absolute in memory then the
  85. hunkstructures will be in front of the file.
  86.  
  87. Here is also a possibility to clear some memory just like a BSS segment
  88. to exit just press return.
  89. Please do not use this option if you are inexperienced with use of
  90. trackdisk device.
  91. IO_Offset is the blocknumber * $200 and IO_Lenght must be round off
  92. upwards to a multiple of $200 (already done by bootleg)
  93.  
  94. Remove Bootleg bootblock
  95. ------------------------
  96.  
  97. The disk will be installed (as the cli command :install) and all
  98. blocks that are accessed by the bootblock will be freed.
  99. This might come in handy if you want to change the boot program 
  100. because it didn't work or you are experimenting (whatever)
  101.  
  102. Fillup Disk
  103. -----------
  104.  
  105. Probably the most ingenious option.
  106. It simply clears the whole bitmap so that on the disk are 0 blocks free.
  107. I guess it is nice if you want nobody messing with your disk.
  108. Notice ! No return possible.
  109.  
  110. Fast Format
  111. -----------
  112.  
  113. This isn't really a format because it only rewrites the root and the
  114. bitmap so that it looks like it has been formatted.
  115. Only works on disks that have been Amigados formatted before.
  116. Programs on that disk can be rescued with diskdoctor if you did
  117. this option by mistake.
  118.  
  119. Format whole disk
  120. -----------------
  121.  
  122. This option really formats, initializes and installs a whole disk.
  123. Be careful ! every single byte on that disk will be lost.
  124.  
  125. Change diskname
  126. ---------------
  127.  
  128. Ah this one might be a serious help.
  129. I only included this because someone wanted to change the diskname
  130. after formatting (I wonder why?)
  131.  
  132. Limitations
  133. -----------
  134.  
  135. 69 segments, if the empty blocks are in a row 
  136. No use of DOS library.
  137. No use of deallocate segment because there is no 
  138. actual segment list (allocated in memorytable) in the boot,
  139. this means that you can't use STANDARD reloc decrunchers like
  140. RELOKIT, TNM CRUNCHER etc.
  141. This does not matter because bootleg makes all parts absolute
  142. so a reloc cruncher won't be necessary.
  143. Therefore I recommend BYTEKILLER V1.3, TETRAPACK or POWERPACK 
  144. (also found on UGA utilities 6) 
  145.  
  146. If you by any chance came across (more) bugs or new ideas for an utility
  147. feel free to contact the Jungle Command, any good coders and graphic
  148. artists should contact us because we may have some paid work for you !!!
  149.  
  150. Bootleg V2.1 was programmed in DevPac 2.08 to all you seka users :
  151. Wake up ! Buy a Megabyte and buy DevPac ! The best since sliced bread.
  152. Macros ! Segments ! Debugger ! Full screen texteditor ! Includes !
  153. Optimized code ! Conditional assembling ! Cross reference ! 
  154.  
  155.  
  156. Boil, P.O.Box 68, 3480 DB HARMELEN, HOLLAND.
  157.  
  158.